home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat7 / files.z / files
Encoding:
Text File  |  2002-10-03  |  9.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. FFFFIIIILLLLEEEESSSS((((7777PPPP))))                                                            FFFFIIIILLLLEEEESSSS((((7777PPPP))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      files - local files name service parser library
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      /var/ns/lib/libns_files.so
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The files client library parses traditional local name service
  16.      configuration files such as /_e_t_c/_p_a_s_s_w_d and makes the data available
  17.      through the nnnnssssdddd((((1111MMMM)))) filesystem.  This library is meant to be used only by
  18.      the nnnnssssdddd((((1111MMMM)))) daemon to efficiently access local name service data.
  19.  
  20.      The library ////vvvvaaaarrrr////nnnnssss////lllliiiibbbb////lllliiiibbbbnnnnssss____ffffiiiilllleeeessss....ssssoooo is opened by the nnnnssssdddd((((1111MMMM)))) daemon
  21.      when ffffiiiilllleeeessss is listed as the protocol for some map in a nnnnsssssssswwwwiiiittttcccchhhh....ccccoooonnnnffff
  22.      file.
  23.  
  24.      Extended attributes in the nnnnsssssssswwwwiiiittttcccchhhh....ccccoooonnnnffff file can be used to control the
  25.      behavior of the files library.  Extended attributes are simply lists of
  26.      key/value pairs attached to each object in the nsd filesystem.  The
  27.      attributes supported in this library are:
  28.  
  29.      ccccoooommmmppppaaaatttt
  30.           The ccccoooommmmppppaaaatttt attribute is only used for the password file.  This
  31.           attribute specifies that lines beginning with +/- represent entries
  32.           supported in later libraries and results in a recursive call into
  33.           nsd.  When the directive [[[[nnnnoooottttffffoooouuuunnnndddd====rrrreeeettttuuuurrrrnnnn]]]] follows this line then
  34.           entries which are not in the local password file, or where there is
  35.           no +/- entry which matches will fail.  This allows the historic
  36.           behavior at the cost of performance.  To get the same behavior from
  37.           previous OS releases use the following line for the password entry:
  38.  
  39.                passwd: files(compat) [notfound=return] nis
  40.  
  41.      lllliiiibbbbrrrraaaarrrryyyy____ccccoooommmmppppaaaatttt
  42.           The lllliiiibbbbrrrraaaarrrryyyy____ccccoooommmmppppaaaatttt attribute is set when a entry is generated from a
  43.           +/- compat request.   Similar to the lllliiiibbbbrrrraaaarrrryyyy attribute, it will be
  44.           set to the name of the library that the compat information was
  45.           returned from.
  46.  
  47.      ddddoooommmmaaaaiiiinnnn
  48.           The ddddoooommmmaaaaiiiinnnn attribute determines the path used to find the source
  49.           file.  This attribute is typically inherited from the daemon
  50.           depending on the nsswitch.conf ` file that is being read.  Given the
  51.           configuration file ////vvvvaaaarrrr////nnnnssss////ddddoooommmmaaaaiiiinnnnssss////DDDDOOOOMMMMAAAAIIIINNNNNNNNAAAAMMMMEEEE////nnnnsssssssswwwwiiiittttcccchhhh....ccccoooonnnnffff the
  52.           attribute "domain" is set to DOMAINNAME.  Given a domain DOMAINNAME
  53.           the library would open the file ////vvvvaaaarrrr////nnnnssss////ddddoooommmmaaaaiiiinnnnssss////DDDDOOOOMMMMAAAAIIIINNNNNNNNAAAAMMMMEEEE////FFFFIIIILLLLEEEE
  54.           where file is the tradition file name for each table.  If a table
  55.           does not match one of the traditional files then the table name
  56.           itself is used for the file name.  If the domain attribute is unset
  57.           then the file ////eeeettttcccc////FFFFIIIILLLLEEEE would be used.  See the information about
  58.           the ttttaaaabbbblllleeee and ffffiiiilllleeee attributes below.  A client system can be a
  59.           member of multiple domains by including multiple instances of the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FFFFIIIILLLLEEEESSSS((((7777PPPP))))                                                            FFFFIIIILLLLEEEESSSS((((7777PPPP))))
  71.  
  72.  
  73.  
  74.           ffffiiiilllleeeessss keyword in the nsswitch.conf file like:
  75.  
  76.                hosts: files(domain=engr) files(domain=corp)
  77.  
  78.      ffffiiiilllleeee The file attribute overrides the domain and table attributes to set
  79.           the name of the file to be opened.  If the file begins with a
  80.           leading '/' then that file is simply opened.  If not, then the
  81.           contents of this attribute are appended to the directory name --
  82.           either ////eeeettttcccc//// for the default domain, or ////vvvvaaaarrrr////nnnnssss////ddddoooommmmaaaaiiiinnnnssss////DDDDOOOOMMMMAAAAIIIINNNNNNNNAAAAMMMMEEEE////
  83.           when the domain attribute is set.  The default files for each of the
  84.           traditional maps are as follows:
  85.  
  86.                lB lB l l .  Filename  Tables aliases   mail.aliases,
  87.                mail.byaddr capability     capability.byname
  88.                clearance clearance.byname ethers    ethers.byname,
  89.                ethers.byaddr group     group.byname, group.bygid,
  90.                group.bymember hosts     hosts.byaddr, hosts.byname
  91.                mac  mac.byname, mac.byvalue netgroup  netgroup,
  92.                netgroup.byuser, netgroup.byhost networks  networks.byaddr,
  93.                networks.byname passwd    passwd.byname, passwd.byuid
  94.                protocols protocols.byname, protocols.bynumber rpc  rpc.byname,
  95.                rpc.bynumber services  services, services.byname
  96.                shadow    shadow.byname
  97.  
  98.      kkkkeeeeyyyy  The key attribute is used to fetch the data from the file.  It is
  99.           set by the nsd(1M) daemon.  Each of the traditional files uses the
  100.           key in a different way.  For instance when looking up an address in
  101.           the hhhhoooossssttttssss....bbbbyyyyaaaaddddddddrrrr map the library would open up the hhhhoooossssttttssss file,
  102.           convert the key to an address, then walk through the file one line
  103.           at a time converting the first string in the file to an address and
  104.           then doing an address comparison until one matched.
  105.  
  106.      ttttaaaabbbblllleeee
  107.           The table attribute is typically inherited from the daemon based on
  108.           the line from which this entry occurs in the nsswitch.conf file.  In
  109.           the above example the ttttaaaabbbblllleeee attribute would be set to hhhhoooossssttttssss....bbbbyyyynnnnaaaammmmeeee
  110.           or hhhhoooossssttttssss....bbbbyyyyaaaaddddddddrrrr depending on the context of the request.  This
  111.           attribute is used as the file name containing the data unless the
  112.           table matches one of the traditional files (see ffffiiiilllleeee attribute
  113.           above).  For the hhhhoooossssttttssss....bbbbyyyynnnnaaaammmmeeee map in the default domain the file
  114.           ////eeeettttcccc////hhhhoooossssttttssss would be opened and searched.
  115.  
  116.      sssseeeeppppaaaarrrraaaattttoooorrrr
  117.           The separator attribute is used when using the files library to
  118.           support a non-traditional file.  The file is expected to be of the
  119.           format:
  120.                keySEPARATORvalue
  121.           The separator is a string which is passed directly to the ssssttttrrrrttttooookkkk((((3333CCCC))))
  122.           function.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. FFFFIIIILLLLEEEESSSS((((7777PPPP))))                                                            FFFFIIIILLLLEEEESSSS((((7777PPPP))))
  137.  
  138.  
  139.  
  140. FFFFIIIILLLLEEEESSSS
  141.      /etc/nsswitch.conf, /etc/aliases, /etc/capability, /etc/clearance,
  142.      /etc/ethers, /etc/group, /etc/hosts, /etc/mac, /etc/netgroup,
  143.      /etc/networks, /etc/passwd, /etc/protocols, /etc/rpc, /etc/services,
  144.      /etc/shadow
  145.  
  146. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  147.      nsd(1M), strtok(3C), nsswitch.conf(4), aliases(4), capability(4),
  148.      clearance(4), ethers(4), group(4), hosts(4), mac(4), netgroup(4),
  149.      networks(4), passwd(4), protocols(4), rpc(4), services(4), shadow(4)
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.